home *** CD-ROM | disk | FTP | other *** search
/ Spacewalker F97 / Spacewalker F97.iso / RECYCLED / DD464.TXT < prev    next >
Encoding:
Text File  |  1997-04-10  |  21.3 KB  |  583 lines
  1.            OS/2 Video Device Driver for the S3 ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX
  2.               Driver Version 1.01.11
  3.  
  4.   This package contains an OS/2 graphics-accelerator device driver
  5.   supporting the ViRGE and ViRGE/VX chip sets from S3 Incorporated.
  6.  
  7.  
  8.  
  9.   Important:
  10.  
  11.   o  "S3 DRV1" must be the label on the installation diskette in this
  12.      package.  This label can be applied using the DOS or OS/2 LABEL
  13.      command.  The installation will fail without this step.
  14.  
  15.   o  Read this entire document before beginning the device driver
  16.      installation.
  17.  
  18.  
  19.   1.0  Supported Features
  20.   _______________________
  21.  
  22.   This ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX, graphics-accelerator device driver provides seamless
  23.   support for accelerated display graphics and advanced color resolutions
  24.   when used with the minimum required video memory.  It conforms to the
  25.   OS/2 32-bit, flat memory model and is designed to function as a
  26.   32-bit Presentation Manager graphics-display device driver under the
  27.   OS/2 32-bit graphics engine.    This device driver supports setting
  28.   the refresh rate using the System - Settings notebook (page 2 of
  29.   the Screen tab) in the OS/2 System Setup folder, and monitor
  30.   detection using Display Data Channel (DDC) protocols.
  31.  
  32.  
  33.   1.1  Supported Resolutions
  34.  
  35.       |========================================|
  36.       | Mode |    Resolution | Memory  |    Virge  |
  37.       |      |           | Required| Family  |
  38.       |      |           |         | Virge   |
  39.       |      |           |         |Virge/vx |
  40.       |------|-------------|---------|---------|
  41.       |  101 | 640x480x8   |   2 MB  |      Y    |
  42.       |------|-------------|---------|---------|
  43.       |  103 | 800x600x8   |   2 MB  |      Y    |
  44.       |------|-------------|---------|---------|
  45.       |  105 | 1024x768x8  |   2 MB  |      Y    |
  46.       |------|-------------|---------|---------|
  47.       |  107 | 1280x1024x8 |   2 MB  |      Y    |
  48.       |------|-------------|---------|---------|
  49.       |  111 | 640x480x16  |   2 MB  |      Y    |
  50.       |------|-------------|---------|---------|
  51.       |  114 | 800x600x16  |   2 MB  |      Y    |
  52.       |------|-------------|---------|---------|
  53.       |  116 | 1024x768x16 |   2 MB  |      Y    |
  54.       |------|-------------|---------|---------|
  55.       |  11A | 1280x1024x16|   4 MB  |      Y    |
  56.       |------|-------------|---------|---------|
  57.       |------|-------------|---------|---------|
  58.       |  112 | 640x480x24  |   2 MB  |      Y    |
  59.       |------|-------------|---------|---------|
  60.       |  115 | 800x800x24  |   2 MB  |      Y    |
  61.       |------|-------------|---------|---------|
  62.       |  118 | 1024x768x24 |   4 MB  |      Y    |
  63.       |------|-------------|---------|---------|
  64.       |  11B | 1280x1024x24|   4 MB  |    Y    |
  65.       |------|-------------|---------|---------|
  66.       |  120 | 1600x1200x8 |   2 MB  |      Y    |
  67.       |------|-------------|---------|---------|
  68.       |========================================|
  69.  
  70.      NOTES:
  71.  
  72.      o Y = Supported; N/S = Not Supported.
  73.  
  74.      o 1280x1024x24bpp is supported with the ViRGE/vX chip only.
  75.  
  76.      o 1 MB only - 640x480x24 is supported for 1 MB memory
  77.        configuration only; for 2 MB and above, 32 bits per pixel (bpp)
  78.        is supported.
  79.  
  80.      o S3 BIOS supports 800x600x16 with 1 MB; S3 OS/2 device driver
  81.        needs 2 MB of memory.
  82.  
  83.      The 32 bpp device driver might need a large swap space on the
  84.      hard disk, for example, 15 MB.
  85.  
  86.  
  87.   2.0  Compatibility
  88.   __________________
  89.  
  90.   This graphics-accelerator device driver is compatible with OS/2
  91.   2.11, and OS/2 Warp 3.0, and OS/2 Warp 4.0
  92.  
  93.   3.0  DDC Monitor Support
  94.   _______________________________________
  95.  
  96.   VESA Display Data Channel (DDC) 1 and 2B protocols are supported,
  97.   allowing similarly enabled computers and operating system software
  98.   to identify the monitor and its capabilities.  This device driver
  99.   automatically detects DDC monitor capabilities and sets the display
  100.   to the maximum refresh rate supported by the monitor.  If, after
  101.   installing this device driver, you switch from a non-DDC monitor to
  102.   a DDC monitor or switch to a different DDC monitor, you must run the
  103.   DDC Display Setup program in the System Setup folder.
  104.  
  105.   Use the following procedures when installing a DDC monitor.
  106.  
  107.     1. Reset the display to the lowest refresh rate available.    This
  108.        will prevent the system from attempting to display at a refresh
  109.        rate higher than that supported by the new monitor.
  110.  
  111.     2. Shut down your system and install the new monitor.
  112.  
  113.     3. Restart your system.
  114.  
  115.     4. Select the "DDC Display Setup" icon in the OS/2 System Folder.
  116.  
  117.     5. When you are instructed to do so, shut down your system and
  118.        restart it.
  119.  
  120.  
  121.   4.0  Preliminary Steps
  122.   ______________________
  123.  
  124.   The following steps must be performed before you install the
  125.   ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX, graphics-accelerator device driver:
  126.  
  127.   1.  You must have OS/2 DOS Support installed.
  128.   2.  If you previously installed SVGA support, you must reset the
  129.       resolution to VGA mode, using the procedures in "Setting Your
  130.       Display to VGA Mode" (section 5.0 in this README).
  131.   3.  The device driver diskette must be labeled "S3 DRV1."
  132.   4.  After driver installation, the OS/2 SYSLEVEL command may be used to
  133.       confirm the new driver version level.  It may also be used prior to
  134.       installation to verify the current driver version, however, some
  135.       previous device drivers did not provide this information.  Following
  136.       execution of the SYSLEVEL command look for the following information:
  137.  
  138.       C:\OS2\INSTALLATION\SYSLEVEL.VID
  139.                     ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX
  140.       Version 2.81     Component ID 562107701
  141.       Current CSD level: S328103
  142.       Prior   CSD level: S328018
  143.  
  144.       In this case the current version level is S3 2.81.03.
  145.   5.  In some situations, installing this driver over 2.80.xx and 2.81.xx
  146.       versions of the driver can result in duplicated icons.  To prevent
  147.       this problem, you should delete the "S3 Windows Font Size" and
  148.       "DDC Display Setup" icons from the System Setup Folder prior to
  149.       installing this driver.
  150.  
  151.  
  152.   5.0  Setting Your Display to VGA Mode
  153.   _____________________________________
  154.  
  155.   Use the following procedures to reset to VGA mode.
  156.  
  157.   NOTE: If your display is out of sync, start OS/2 using the OS/2
  158.     Installation Diskette.    Insert Diskette 1 when prompted, press
  159.     F3 to display a command prompt, and then use the following
  160.     instructions to reset your display mode.
  161.  
  162.   o   If you are installing this driver on OS/2 2.11 or OS/2 for
  163.       Windows, and you installed from diskettes, do the following:
  164.  
  165.       1.  Under OS/2 2.1/2.11, before running RSPDSPI, delete the following
  166.       file:
  167.  
  168.        [OS2 DRIVE]:\OS2\INSTALL\00S3.DSC
  169.  
  170.       3.  Be sure RSPDSPI.EXE is in the \OS2\INSTALL directory.  If it
  171.       is, go to step 3.  If it is not, insert Diskette 8 into
  172.       drive A and unpack RSPDSPI.EXE with the following command:
  173.  
  174.         C:\OS2\UNPACK A:\INSTAID C: /N:RSPDSPI.EXE
  175.  
  176.       where A: is the drive containing Diskette 8, and C: is the
  177.       drive where OS/2 is installed.
  178.  
  179.       4.  Type C: and then press Enter.
  180.  
  181.       5.  Type CD C:\OS2\INSTALL and then press Enter.
  182.  
  183.       6.  Type the following:
  184.  
  185.         RSPDSPI /PK:VGA /SK:NONE /S:A:\ /T:C:
  186.  
  187.       In /T:C:, C: is the target drive where OS/2 is installed.  In /S:A:,
  188.       A: is the source diskette drive for installing the device driver.
  189.  
  190.       Then press Enter.
  191.  
  192.       7.  Perform a shutdown and restart your computer.
  193.  
  194.   o   If you are installing this driver on OS/2 2.11 or OS/2 for
  195.       Windows, and you installed from CD-ROM or a LAN, do the
  196.       following:
  197.  
  198.       1.  Under OS/2 2.1/2.11, before running RSPDSPI, delete the following file:
  199.  
  200.         [OS2 DRIVE]:\OS2\INSTALL\00S3.DSC
  201.  
  202.       3.  Be sure RSPDSPI.EXE is in the \OS2\INSTALL directory.  If it
  203.       is, go to step 3.  If it is not, unpack RSPDSPI.EXE with the
  204.       following command:
  205.  
  206.          C:\OS2\UNPACK E:\DISK_8\INSTAID C: /N:RSPDSPI.EXE
  207.  
  208.       where C: is the drive where OS/2 is installed, and E: is
  209.       the CD-ROM or LAN drive.
  210.  
  211.       4.  Type C: and then press Enter.
  212.  
  213.       5.  Type CD C:\OS2\INSTALL and then press Enter.
  214.  
  215.       6.  Type the following:
  216.  
  217.         RSPDSPI /PK:VGA /SK:NONE /S:E:\OS2SE21\ /T:C:
  218.  
  219.       In /T:C:, C: is the target drive where OS/2 is installed.  In /S:E:,
  220.       E: is the source CD-ROM or LAN drive.
  221.  
  222.       Then press Enter.
  223.  
  224.       7.  Perform a shutdown and restart your computer.
  225.  
  226.  
  227.   6.0  Installing from Diskette
  228.   _______________________________
  229.  
  230.   To install the ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX device driver from diskette, do the
  231.   following:
  232.  
  233.   1.  If system is not in VGA mode, select VGA mode.
  234.  
  235.   2.  Insert the ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX diskette into drive A (or any other
  236.       diskette drive).
  237.  
  238.       Note: "S3 DRV1" must be the volume label of this diskette.
  239.       To verify the label, use "Label A:".
  240.  
  241.   3.  Open an OS/2 full-screen or OS/2 window session.
  242.  
  243.   4.  At the OS/2 command prompt, type the following command to copy
  244.       all necessary files to the OS/2 drive:
  245.  
  246.     A:SETUP
  247.  
  248.       where A: is the diskette drive.
  249.  
  250.       Then press Enter.
  251.  
  252.       Setup will then identify your chipset.  When prompted to do so, press
  253.       Enter to continue.
  254.  
  255.   10. When the Monitor Configuration/Selection Utility window appears,
  256.       the "Install Using Defaults for Monitor Type" choice is
  257.       preselected.  You can accept this choice or select "Install
  258.       Using Display Adapter Utility Program" to choose a different
  259.       refresh rate.  Then select OK.
  260.  
  261.       If you select the "Install Using Display Adapter Utility
  262.       Program" choice, you must have the DOS monitor utility program
  263.       that came with your display adapter.  Contact the display
  264.       adapter manufacturer's technical support for information on how
  265.       to use the monitor utility program under OS/2.
  266.  
  267.       NOTE:  DSPINSTL determines the hardware configuration by
  268.          creating the \OS2\SVGADATA.PMI file.  If the
  269.          \OS2\SVGADATA.PMI file has not been created, the adapter
  270.          will not be supported.  This process can take several
  271.          seconds and will black-out the screen.
  272.  
  273.  
  274.   6. When the installation is complete, shut down your system, remove
  275.       the diskette, and restart your computer.
  276.  
  277.   7. When the system has restarted:
  278.       a.  Open the OS/2 System folder.
  279.       b.  Open the System Setup folder.
  280.       c.  Open the System object.
  281.       d.  When the Settings notebook appears, select the Screen tab.
  282.       If your monitor has been detected as Plug and-Play (DDC)
  283.       compatible, go to step 15.
  284.  
  285.   8. On Screen page 2, select your display from the display list. If
  286.       your display does not appear in the list, select Default.
  287.  
  288.       It might be necessary to restart your computer to have all
  289.       refresh rate options available.
  290.  
  291.   9. When the system has restarted:
  292.       a. Open the System object and select Screen page 1, as in step
  293.      13.
  294.       b. Select a screen resolution and a screen refresh rate.
  295.       c. Close the Settings notebook.
  296.       d. Perform a shutdown and restart your computer.
  297.  
  298.   NOTES:
  299.  
  300.    o During the installation of this driver, DISPLAY.LOG and
  301.      DSPINSTL.LOG files are created in the OS/2\INSTALL directory.
  302.      These files identify the OS/2 system files that were updated and
  303.      indicate whether the installation was successful.    The contents
  304.      of these files might be useful if you need to report an
  305.      installation problem to IBM.
  306.  
  307.    o If the video memory size is changed after the device driver is
  308.      installed, the device driver must be reinstalled in order for
  309.      the system to recognize the change.  Not reinstalling the driver
  310.      might result in serious system problems.
  311.  
  312.    o When starting a WIN-OS/2 session it is recommended that the user launch
  313.      the session via one of the WIN-OS/2 icons located in the "Command
  314.      Prompts" folder within the "OS/2 System" icon.  For additional information
  315.      see section 10.0 Limitations.
  316.  
  317.  
  318.   7.0  Installing in a CID Environment
  319.   ______________________________________
  320.  
  321.   NOTES:
  322.  
  323.    o The server must contain a directory named S3_DRVS on the same
  324.      drive where the OS/2 diskettes reside.  The S3_DRVS directory
  325.      must contain all of the files from the ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX device driver
  326.      diskette.
  327.    o OS/2 must have been successfully installed on the client using
  328.      the CID (Configuration Installation Distribution) method.
  329.  
  330.   To install the ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX graphics-accelerator device driver
  331.   using CID, use the following information to modify your LCU command
  332.   file.
  333.  
  334.   NOTE:  The following information is meant as a guide.
  335.      Your LCU command file might be different.
  336.  
  337.     /*****************************************************/
  338.     /*         LCU PRODUCT DATA SECTION         */
  339.     /*****************************************************/
  340.  
  341.               .
  342.               .
  343.               .
  344.  
  345.     x.s3video = 15
  346.     x.15.name='S3 Video'
  347.     x.15.statevar = 'CAS_' || x.15.name
  348.     x.15.instprog = 'x:\img\s3_drvs\SETUP.CMD',
  349.             ' /u /res:640x480x256'
  350.     x.15.rspdir   = ''
  351.     x.15.default  = ''
  352.  
  353.     /*---------------------------------------------------*/
  354.     /*           NUMBER OF PROGRAMS SET UP IN THE      */
  355.     /*             PRODUCT DATA SECTION         */
  356.     /*---------------------------------------------------*/
  357.  
  358.     NUM_INSTALL_PROGS = 15
  359.  
  360.     /*****************************************************/
  361.     /*            INSTALLATION SECTION         */
  362.     /*****************************************************/
  363.               .
  364.               .
  365.               .
  366.  
  367.     when OVERALL_STATE = 2 then do
  368.       if RunInstall(x.s3video) == BAD_RC then exit
  369.       Call RebootAndGotoState(3)
  370.     end
  371.     when OVERALL_STATE = 3 then do
  372.       if RunInstall(x.s3dspinstl) == BAD_RC then exit
  373.       Call CheckBoot
  374.     end
  375.               .
  376.               .
  377.               .
  378.  
  379.     /******************************************************/
  380.     /*              ROUTINE SECTION              */
  381.     /*    The following information should already exist in */
  382.     /*    the LCU command file.                  */
  383.     /******************************************************/
  384.              .
  385.              .
  386.              .
  387.     RebootAndGotoState:
  388.       parse arg new_state, other
  389.  
  390.       rc2 = SetState(new_state, 'RebootAndGotoState', 1)    /* Set the state */
  391.                                 /*    to go to in  */
  392.                                 /* OVERALL_STATE */
  393.  
  394.       Call SaveStates                /* Save the environment vars */
  395.  
  396.       Call Reboot                /* Reboot the machine */
  397.  
  398.       return
  399.  
  400.               .
  401.               .
  402.               .
  403.  
  404.  
  405.     /*****************************************************/
  406.         END OF LCU INFORMATION TO BE ADDED
  407.     /*****************************************************/
  408.  
  409.   Following is an explanation of the line that is
  410.   executed in the LCU command file:
  411.  
  412.     C:\OS2\INSTALL\DSPINSTL /pd:c:\os2\install\00S3.dsc
  413.     /S:X:\img\s3_drvs /T:C: /res:640x480x256 /u
  414.  
  415.        /pd:c:\os2\install\00S3.dsc
  416.     is the dsc laid down during setup phase.
  417.  
  418.        /S:X:\img\s3_drvs
  419.     where X:\img\s3_drvs is the redirected source path.
  420.  
  421.        /T:C:
  422.     where C: is the drive where OS/2 is installed.
  423.  
  424.        /res:640x480x256
  425.     is a resolution/color depth from the list of "Supported
  426.     Resolutions" that appears earlier in this README.
  427.  
  428.        /u
  429.     means Unattended installation.
  430.  
  431.   NOTES:
  432.  
  433.    o  Be sure you have the stated video memory required, as listed
  434.       in "Supported Resolutions" earlier in this README.  A safe
  435.       choice is 640x480x256.  Any of the listed resolutions can be
  436.       selected, but your display might be damaged if you select a
  437.       resolution that your display does not support.
  438.  
  439.    o  After the ViRGE,ViRGE/VX,ViRGE/DX,ViRGE/GX device driver has been successfully
  440.       installed on the client machine using the CID method and the
  441.       client machine is restarted, the resolution will be as specified
  442.       by command line argument.
  443.  
  444.    o  After the CID installation, refer the end user to section 6.0
  445.       "Installation from Diskette," step 12.
  446.  
  447.   8.0  Selecting Small or Large Fonts for Windows
  448.   _______________________________________
  449.  
  450.   The default font sizes for Windows sessions are listed below.
  451.  
  452.     Resolution        Default Font Size
  453.     ----------        ---------------------------
  454.     640x480        Small
  455.     800x600        Small
  456.     1024x768        Large
  457.     1280x1024        Large
  458.     1600x1200        Large
  459.  
  460.     NOTE: Large fonts are not available for 640x480 resolution.
  461.  
  462.   Use the following procedures to select small or large fonts
  463.   for Windows sessions.
  464.  
  465.     1. Select the "S3 Windows Font Size" object in the OS/2 System
  466.        Setup Folder.
  467.  
  468.     2. Click on the radio button next to the font size you wish to
  469.        select.
  470.  
  471.     3. Click on the OK button.
  472.  
  473.     4. A message will display saying that the new settings will take
  474.        effect the next time you restart your Windows session.
  475.        Currently open sessions will not be affected by the new
  476.        settings.
  477.  
  478.     5. Click on the OK button.
  479.  
  480.     6. Start any WIN-OS/2 window or full-screen session.
  481.  
  482.   The setting you select will remain in effect until you explicitly
  483.   change it, you change your display resolution, or you install a new
  484.   display driver.
  485.  
  486.   9.0  Features and Fixes Included in this Driver
  487.   _____________________________________________
  488.  
  489.   - "System - Settings" notebook support for setting refresh rate
  490.   - DDC monitor detection support
  491.   - Windows "Large font" and "Small font" support in high resolutions
  492.   - WIN-OS/2 based on latest S3 Windows 3.1 drivers
  493.   - One-diskette package
  494.  
  495.   10.0 Limitations
  496.   _______________________
  497.  
  498.   1. CID install pauses due to SVGA.EXE loading in the background.
  499.      Workaround: In the CID install script, do not initiate any other
  500.      processes until DISPINSTL completes execution.  Ensure that no
  501.      other processes are running during CID install.  This can be
  502.      accomplished by adding the following line to the CONFIGSYSLINE
  503.      keyword of the CID response file:
  504.  
  505.      SET RESTARTOBJECTS=STARTUPFOLDERSONLY
  506.  
  507.   2. During CID install of IBM AntiVirus when using NetView DM/2,
  508.      the OS/2 full screen is displayed as a black screen.
  509.      Workaround: Perform CID install under VGA.
  510.  
  511.   3. DISPINSTL does not allow CID selection of monitor and refresh
  512.      rate.  The workaround is as follows:
  513.  
  514.     Requirements:
  515.     * A system with the same graphics card and monitor configured with the
  516.       S3 driver version 2.81.05, the correct display type,
  517.       the desired resolution, and the desired refresh rate.
  518.  
  519.     Step 1: Copy Configured Video/Display Data Files
  520.     * copy the video and display data files containing information about
  521.       the display type, resolution and refresh rate to the CID server
  522.       (\img\svgadata).
  523.  
  524.       > copy \os2\svgadata.pmi x:\img\svgadata
  525.       > copy \os2\video.cfg x:\img\svgadata
  526.  
  527.     Step 2: Create CID Command File
  528.     * create a command file to copy svgadata.pmi and video.cfg to the
  529.       client system's \os2 directory via CID.
  530.     * reboot the client system.
  531.     * the client system will be configured with the correct driver,
  532.       display type, resolution and refresh rate.
  533.  
  534.   4. In all modes, video corruption or out-of-sync screen is
  535.      displayed when using  Alt+Esc to switch between WIN-OS/2,
  536.      OS/2, and DOS window and full-screen sessions started from the
  537.      Startup folder. To avoid this situation, do not start sessions
  538.      from the Startup folder or press Alt+Esc several times to
  539.      restore.
  540.  
  541.   5. Some programs, such as WINBENCH95, WINBENCH96, and After
  542.      Dark 3.0, were written specifically for the Windows environment.
  543.      In the Windows environment, these programs prevent any keystrokes
  544.      from interfering with their proper execution.  However, in the
  545.      OS/2 environment, it is possible to switch context away from the
  546.      Windows session without notifying these programs.    General
  547.      Protection Faults (GPFs) may result.  Therefore, context
  548.      switching during the execution of WINBENCH95 and WINBENCH96 tests
  549.      is not recommended.  Also, context switching during the execution
  550.      of the After Dark 3.0 demo is not recommended.
  551.  
  552.   6. When attempting to start a WIN-OS/2 session from an OS/2 Full Screen
  553.      session by typing "WIN" or "WINOS2" at the command prompt, it will not
  554.      execute with the settings needed to support WIN-OS/2, and will result
  555.      in video corruption and/or a system lockup.  It is recommended that the
  556.      user launch all Windows sessions via one of the WIN-OS/2 icons located
  557.      in the "Command Prompts" folder within the "OS/2 System" icon.
  558.  
  559.   7. When attempting to start a WIN-OS/2 session from a DOS Full screen or
  560.      DOS Window by typing the "WIN" or WINOS2" command, the user must first
  561.      be sure that the video settings of the session are changed to enable
  562.      this feature.  These settings can be changed using the following
  563.      procedure:
  564.       a) Place mouse pointer over the DOS Full Screen icon (or any DOS
  565.      session icon you want to alter).  Press mouse button 2 (MB2), the
  566.      right button, to bring up a context sensitive menu.
  567.       b) Place mouse pointer over "Setting" and press MB1.  Next, place
  568.      mouse pointer over the tab labeled "Session" and press MB1 again.
  569.       c) Use MB1 to chose the "DOS Setting" button.
  570.       d) Use MB1 to chose the "DOS video settings" option, and then click OK.
  571.       e) From the list of settings which appear ensure that
  572.      "VIDEO_8514A_XGA_IOTRAP" is switched OFF, AND
  573.      "VIDEO_SWITCH_NOTIFICATION" is switched to ON,
  574.      then "save" these settings using MB1.
  575.  
  576.  
  577.                 (End of Document)
  578.  
  579.  
  580.  
  581.  
  582. 
  583.